home *** CD-ROM | disk | FTP | other *** search
/ .net (French) 1998 Winter / .net Magazine (FR) - Issue 06.iso / mac / Surfing / INDNET / IRC / ShadowIRC-070 / ShadowIRC Manual < prev    next >
Text File  |  1998-09-30  |  13KB  |  220 lines

  1. ShadowIRC Manual
  2. Manual written by Jonathon Rubin (korendil@shorecrest.org)
  3.  
  4. ShadowIRC is shareware, $10. To register, send cash, check, or money order to:
  5.     ShadowIRC Registration
  6.     John Bafford
  7.     6 Cedar Springs Ct.
  8.     Baltimore, MD 21228
  9.  
  10.  
  11. How to contact John Bafford, writer of ShadowIRC
  12. Email: dshadow@glue.umd.edu
  13. IRC: Undernet: DShadow, #macintosh, #macdev, and #mac
  14. Snail Mail:
  15.             John Bafford
  16.             6 Cedar Springs Ct.
  17.             Baltimore, MD 21228
  18.  
  19. What Is ShadowIRC?
  20.     ShadowIRC is a new Macintosh IRC client from John Bafford, author
  21. of ShadowBot and ICMP Logger. It implements the ultra-fast WASTE text
  22. engine, a powerful, dynamic plugin architecture, and requires very little
  23. memory. It also fully supports the new OS8 "look and feel."
  24.  
  25. What is IRC?
  26.     IRC, or Internet Relay Chat, was created by Jarkko Oikarinen, a student at
  27. Finland's Oulu University, in 1988. Imagine it as AOL's chat rooms--on steroids.
  28. IRC is a protocol--that is, there isn't one 'IRC' network, but many different
  29. networks that all use the same method of communication. They are made up of
  30. linked servers, computers that charitable businesses and organizations set up for IRC
  31. usage. Because servers on the same network are linked, someone on a server
  32. in Australia can talk to someone on a server in Alaska, as long as they are
  33. both on the same IRC network.
  34.  
  35.     IRC's 'rooms', called channels, are not set up by the network. This
  36. is mainly because there isn't any central authority figure. Anyone can make
  37. a channel, simply by trying to join a channel that doesn't exist. Being the
  38. first one in the channel, you would be the channel operator, or op. This
  39. means you can set channel modes (which let you set passwords and moderate
  40. who speaks and hide the channel from others and only let certain people in,
  41. and many more options), kick people out of the channel, and ban them from
  42. it all together. Also, you can op other people. In large channels, this
  43. generally evolves into having the most knowledgeable, trust-worthy, and
  44. long lasting channel members receive the privilege (and burden) of ops.
  45.     Some IRC networks, such as UnderNet, have Services Bots. Bots are
  46. computer programs that people set up for various uses, ranging from benign
  47. to malignant. Services Bots hang out in registered channels, have ops, and
  48. give ops to people they have on their lists. Some channels also have other
  49. bots that they personally run, which perform that and other extended
  50. features. For all that ops are powerful, there are a kind of 'police' on
  51. IRC networks. Called IRC operators, or IRCops, they can kill users--knock
  52. them off servers--and even g-line them--ban them from servers. Be nice to
  53. IRCops, for you are mortal, and easy to kill. IRCops are called in for
  54. major channel takeovers and such. They're extremely overworked people who
  55. volunteer their free time to take care of a bunch of ingrates. Now it's
  56. time to set up the client.
  57.  
  58. Getting Started with ShadowIRC
  59.     Open ShadowIRC. From the File menu, choose Preferences. The first
  60. menu to show up is Connections. First, make sure that Connection 1 is
  61. selected. Give it a distinctive name--maybe UnderNet. Nickname is the name
  62. that will 'be' you on IRC. Choose something original. Alternate Nickname is
  63. what will be used in case your first choice is in use. A few IRC networks
  64. have an 'InterNick' service which lets you lay claim to a certain nick. But
  65. most don't. For Username, type in your username at your ISP. Real name can
  66. be whatever you want, and only shows up when someone /whois-es you.
  67. Username, though, is part of your hostmask. For example, when I sign on, my
  68. hostmask is korendil@ppp13.icubed.net. This is because I put korendil in as
  69. my user name. This is useful when people want to email you--or ban you.
  70. Now, for Server Name and Port, you need to know the IRC server you want to
  71. connect to. The port is almost always 6667, though often other portnumbers
  72. near that will work. For UnderNet, check out
  73. newbrunswick.nj.us.undernet.org, or phoenix.az.us.undernet.org. You can
  74. find info on other networks' servers on the Web. The Connection Script
  75. allows you to set several commands to be executed as you sign on. These are
  76. separated by semi-colons. For example, if I wanted to log in to X, message
  77. a friend hello, and join a channel, my connection script would look like
  78. this: //msgq x@channels.undernet.org login #channel password;/msg DShadow
  79. Heyla, John;/join #macintosh . Note that when I messaged my password to X,
  80. I did not use the normal 'msg' command. This demonstrates one of
  81. ShadowIRC's subtle-yet-useful security features. msgq is not shown on the
  82. screen, and a double-slash before any command keeps it out of the input
  83. line buffer.
  84.     With your basic preferences set, it's time to sign on! First, so
  85. you don't have to enter all of that each time you use ShadowIRC, select
  86. Save Preferences from the File menu. Now, choose Open Connection from the
  87. File menu, and select the name of the Connection Preferences that you
  88. filled out to open. That's it! And as for a channel to join....why not
  89. consider #macintosh?
  90.  
  91. Teach Me How To Be A Power User, Please
  92.     You can use IRC. You've been using IRC for years. What can
  93. ShadowIRC offer you? A lot. The most powerful feature of ShadowIRC isn't
  94. really even part of the program. ShadowIRC has an amazingly powerful plugin
  95. architecture, allowing someone with a knowledge of C to do whatever they
  96. want to the client. This can include plugins that act like the scripting
  97. packages other clients offer (such as PurePak for Un*x's IRCii) to
  98. userlists to colors. The possibilities are endless. You can find links to
  99. many plugins at ShadowIRC's homepage,
  100. <http://glue.umd.edu/~dshadow/shadowirc>. To load plugins, place them in
  101. the Plugins folder inside your ShadowIRC folder, and then launch the client.
  102.  
  103.     Not all ease-of-use requires programming talent.  Instead of typing
  104. /whois, you can just type /wh for the result. This also applies to /ww, for
  105. /whowas. Shortcuts offer more simple macros, or key-combos that call more
  106. information. Passwords, or URLs that you often hand out can be stored in
  107. these. From the Shortcuts menu, select Edit Shortcuts. Fill in the fields
  108. with the information you want, and then click on Done. Again, to store the
  109. information for good, choose Save Preferences from the File menu. The data
  110. you stored can be accessed by hitting command and the number of the field you entered the
  111. information in. Forget which one it's in? Click on the Shortcuts menu and
  112. it will be right next to the number you have to press. Shortcuts are more
  113. powerful than they first appear. To learn more, look at the Shortcuts
  114. section of the Command Index.
  115.  
  116.     See the letters to the left of the channel topic in the lower bar
  117. of channel windows? These allow swift change of channel modes. Clicking on
  118. lower-case ones activate the modes, and clicking on capital letters
  119. deactivates the modes. Of course, to do this you have to be an operator in
  120. the channel.
  121.  
  122.     The input line holds three treasures, time-saving pop-up menus.
  123. Click-holding on your nickname, which is in bold, lets you switch between
  124. recent nicks. You can also choose Clear List, to get rid of all the nicks
  125. you've been using. Click-holding on the channel name, which is also in
  126. bold, lets you flit between active windows without hardly moving the mouse.
  127. Under Recent Channels you can find all the channels you've joined lately.
  128. Want to know exactly how much memory ShadowIRC has free? Clicking on the
  129. memory indicator on the far right of the input window switches it between
  130. showing kilobytes, and the bytes free.
  131.  
  132.     The Commands menu also offers some time-savers. Users of some other
  133. IRC clients might be familiar with the Commands menu, but ShadowIRC greatly
  134. expands on its capabilities. By choosing one of the often used commands
  135. from the menu, they appear in your input  window, saving time. Furthermore,
  136. they customize for what window you are in. So command-t will not only put
  137. /topic in the input window, but the channel name too (/topic #channel). Even better, just click the topic at the bottom of the channel window, for an easy-to-edit dialog box.
  138.  
  139.     Think someone mentioned your favorite band a few minutes ago while
  140. you weren't paying attention? The Edit menu holds a Find function. Just
  141. enter the text, and ShadowIRC will home in on it. Even better, you can log
  142. a channel. First, in the Log Preferences, select afolder to save logs to.
  143. Then, in the channel, control-click and choose Start Logging from the
  144. contextual menu. ShadowIRC's use of this new Apple Innovation don't stop
  145. there, either! Take a look at that contextual menu--you might see a few
  146. other time-savers too! Note: OS-level contextual menu support is NOT
  147. required: contextual menus work on any PowerPC machine.
  148.  
  149.     ShadowIRC now supports multiple connections (and John can hear
  150. those sighs of relief....). Just fill out the preferences for each
  151. Connection in the Connection Preferences, and give it a distinctive name,
  152. so you remember which is which. To open a Connection, either choose it from
  153. the Open Connection command in the File menu, or control-click and choose
  154. it from the contextual menu. This works the same way to disconnect.
  155. Commands will affect whichever server's channels are currently active. To
  156. switch Connections in the console, click and hold on the bar at the bottom
  157. of the window.
  158.  
  159.     Veteran MacOS IRCers will remember Homer, an older client with a
  160. great GUI that hasn't been updated in years. One of its few useful features
  161. was cursor-focusing, now available ShadowIRC. With cursor-focusing
  162. turned on in the Preferences, whatever channel the mouse cursor is over
  163. becomes active.
  164.  
  165.     For security, ShadowIRC has two fore-mentioned features. By placing
  166. two slashes in front of any command, it isn't saved in the input buffer.
  167. This means if someone uses the arrow keys to scroll through recent entries
  168. on the input line, those commands won't be there. Two commands, msgq and
  169. noticeq, do not display on the screen. This means that if you send your
  170. password to a bot, and someone walks by, your password won't be on the
  171. screen in front of you.
  172.  
  173.     ShadowIRC is extremely configurable. Explore! The Preferences alone
  174. hold a lot of extras to be found (like the ability to turn colors and
  175. stylized text off). Some users, though, will want colors turned *on*. There
  176. are two choices: you can use Ircle-style colors, or mIRC-style colors.
  177. Unfortunately, it is impossible to display both at the same time--but you can decide which to use for each window. Other little things, like the key-combos for various functions, benefit from exploration.
  178.  
  179.     Look around. It's likely you'll find something worthwhile. And if what you
  180. want isn't there, just email John--or write the plugin!
  181.  
  182. Can I Write Plugins Too?
  183.     Yes! To write plugins, though, you will need to know C, have a
  184. compiler (such as Metrowerk's excellent CodeWarrior), and get the SDK. This
  185. holds the info needed to start coding your plugin. You can get it from the
  186. ShadowIRC Plugins page, <http://www.glue.umd.edu/~dshadow/plugins.html> .
  187.     For more help, join the ShadowIRC developer mailing list. To
  188. subscribe to the list, send email to majordomo@home.amug.org containing
  189. 'subscribe shadowirc-development'. Also, check out #macdev on Undernet.
  190. Good luck...and remember: if C isn't up your alley, you can always beg a
  191. friend! <g>
  192.  
  193. Okay, Where Can I Go For More Info?
  194.     Well, be sure to check out the ShadowIRC homepage,
  195. <http://www.glue.umd.edu/~dshadow/shadowirc> , every once in awhile for
  196. updates and news. A list of plugins can also be found there. For updates on
  197. new betas, consider joining the ShadowIRC announcement mailing list by
  198. sending an email to majordomo@home.amug.org containing 'subscribe
  199. shadowirc-announce'. Note: this mailing list is moderated, and it is only
  200. for announcements of updates.
  201.     You can also check out #macintosh on Undernet. A lot of regulars
  202. there use ShadowIRC, plus you might be lucky enough to catch John Bafford
  203. himself. John's been really busy lately, so as a kindness, please direct
  204. questions to either the channel, or to me, the humble manual writer,
  205. Jonathon Rubin (Korendil on #macintosh on Undernet) (korendil@shorecrest.org).
  206.  
  207. ShadowIRC is great! Is it shareware or something?
  208.     Yeah, or something. ShadowIRC is $10 shareware. John Bafford wrote ShadowIRC because he wanted another choice in IRC clients for MacOS. He works hard, he deserved credit. How can you show that you appreciate his work? Pay him. ShadowIRC is shareware, not freeware. There aren't any penalties for not paying, except that without any impetus to continue, John can't commit as much time as he'd like to making ShadowIRC even better. Shop around. Check out other clients. None of the others are going to be so inexpensive while offering so many great features and so much expandability.
  209.     A lot of people don't pay for shareware. That doesn't mean you
  210. shouldn't. Shareware is extremely important on the Internet, and paying for
  211. ShadowIRC gives John and other developers reason to continue writing great
  212. applications to extend the possibilities of the Internet, and the MacOS.
  213.     To register, send cash, check, or money order to:
  214.  
  215.         ShadowIRC Registration
  216.         John Bafford
  217.         6 Cedar Springs Ct.
  218.         Baltimore, MD 21228
  219.  
  220.